home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 February
/
EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso
/
earcd
/
program
/
gtld3656.lha
/
GadUtil
/
Docs
/
AutoDocs
/
05.GU_GetIMsg
< prev
next >
Wrap
Text File
|
1995-06-17
|
2KB
|
49 lines
gadutil.library/GU_GetIMsg gadutil.library/GU_GetIMsg
NAME
GU_GetIMsg -- Get an IntuiMessage, process GadTools & Hotkey events.
SYNOPSIS
imsg = GU_GetIMsg(intuiport)
D0,A0,SR(Z) A0
struct IntuiMessage *GU_GetIMsg(struct MsgPort *);
FUNCTION
Use GU_GetIMsg() in place of the usual exec.library/GetMsg() when
reading IntuiMessages from your window's UserPort. If needed, the
GadTools dispatcher will be invoked, and suitable processing will
be done for gadget actions.
If the message is an IDCMP_VANILLAKEY or an IDCMP_RAWKEY, this
routine will search through all gadgets for that key, and if it is
found, the message will change to the type of message that gadget
is supposed to send. If the key is not used as a hotkey, the
message will not change.
If there are no messages (or if the only messages are meaningful
only to GadTools/GadUtil), NULL will be returned.
INPUTS
intuiport - the Window->UserPort of a window that is using the
GadUtil library.
RESULT
imsg - pointer to modified IntuiMessage, or NULL if there are
no applicable messages.
SR (Z) - the zero flag will be set if there was no message. This
is probably only useful for assembly language programmers.
NOTES
Be sure to use GU_ReplyIMsg() and not exec.library/ReplyMsg() on
messages obtained with GU_GetIMsg().
If you intend to do more with the resulting message than read its
fields, act on it, and reply it, you may find GU_FilterIMsg()
more appropriate.
Starting with V39 (of the OS), this function actually returns a
pointer to an ExtIntuiMessage structure, but the prototype was
not changed for source code compatibility with older software.
SEE ALSO
GU_ReplyIMsg(), GU_FilterIMsg()